home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 4.iso / documents / OpenGL / README < prev    next >
Text File  |  1994-08-01  |  14KB  |  272 lines
  1.  
  2.                 ~4Dgifts/toolbox/documents/OpenGL README
  3.  
  4.  
  5.      `!' indicates new or updated as of version 4.2
  6.  
  7.  
  8.     Contents:
  9.  
  10.  !  opengl.ps:  "The Design of the OpenGL Graphics Interface"
  11.   
  12.       ABSTRACT:  OpenGL is an emerging graphics standard that provides 
  13.       advanced  rendering features while maintaining a simple programming 
  14.       model.  Because OpenGL is rendering-only, it can be incorporated into
  15.       any window system (and has been, into the X Window System and a soon-to-
  16.       be-released version of Windows) or can be used without a window system.
  17.       An OpenGL implementation can efficiently accommodate almost any level of
  18.       graphics hardware, from a basic framebuffer to the most sophisticated
  19.       graphics subsystems.  It is therefore a good choice for use in 
  20.       interactive 3D and 2D graphics applications.
  21.         We describe how these and other considerations have governed the 
  22.       selection and presentation of graphical operators in OpenGL.  Complex
  23.       operations have been eschewed in favor of simple, direct control over 
  24.       the fundamental operations of 3D and 2D graphics.  Higher-level 
  25.       graphical functions may, however, be built from OpenGL's low-level
  26.       operators, as the operators have been designed with such layering in
  27.       mind.
  28.  
  29.  -----------------------------------------------------------------------------
  30.  
  31.     OpenGLtutorial:  this directory contains files of the tutorial notes for 
  32.              the "OpenGL and X" tutorial presented as the 8th Annual 
  33.              X Technical Conference in Boston, on January 24, 1994:
  34.       woo.ps       Mason Woo's presentation introducing OpenGL and its 
  35.                    functionality (49 pages).
  36.       mjk.showcase Mark Kilgard's presentation on how OpenGL integrates with 
  37.                    the X Window System (53 pages).
  38.       segal.ps     Mark Segal and Kurt Akeley's paper describing the "The 
  39.                    OpenGL Graphics Interface" (21 pages).
  40.  
  41.  -----------------------------------------------------------------------------
  42.  
  43.     analysisPEX: Analysis of PEX 5.1 and OpenGL 1.0
  44.  
  45.       PEX and OpenGL are two 3D graphics systems contending for the position
  46.       of de facto standard in the workstation market. While they are similar
  47.       in many ways, they also differ in important aspects of their
  48.       application programming interfaces, functionality, performance,
  49.       portability, openness, and responsiveness to changes in markets and in
  50.       technology.
  51.       
  52.       To our knowledge, no detailed comparisons of PEX and OpenGL have been
  53.       published. Perhaps this is because the two systems are evolving and few
  54.       individuals have experience with both. With the release of PEX 5.1 and
  55.       OpenGL 1.0, we believe the systems are relatively stable and it is now
  56.       time to undertake a comparison.
  57.       
  58.       This paper analyzes some of the significant differences between PEX and
  59.       OpenGL, with attention to issues faced by users as well as
  60.       implementors. We hope it will be a positive contribution to the
  61.       debate.
  62.  
  63.  -----------------------------------------------------------------------------
  64.  
  65.     irixgl2opengl.ascii:  a list mapping IrisGL commands to similar OpenGL
  66.                           commands.
  67.  
  68.       Note in many cases the OpenGL commands listed function somewhat 
  69.       differently from the IrisGL commands, and the format of the parameters 
  70.       may be different as well.  See the OpenGL man pages for detailed 
  71.       descriptions of the functions of the these commands and the parameters 
  72.       they take.
  73.  
  74.  -----------------------------------------------------------------------------
  75.  
  76.     irisgl2opengl.ps:  PostScript version of the list mapping IrisGL commands 
  77.                to similar OpenGL commands--expanded contents
  78.  
  79.       Similar to the irisgl2opengl ascii text file, this file also includes
  80.       a "Where Discussed" column for each command.  This is Appendix A of 
  81.       "The OpenGL Porting Guide" Iris Insight Help book.
  82.  
  83.  -----------------------------------------------------------------------------
  84.  
  85.     intro.ps:    "OpenGL(tm) and X, Part 1:  An Introduction", Mark Kilgard,
  86.          "The X Journal", November/December, 1993.
  87.  
  88.       The OpenGL graphics system is a high-performance, window system 
  89.       independent 2D and 3D graphics interface.  The technology was developed
  90.       by Silicon Graphics and is now controlled by the OpenGL Architecture 
  91.       Review Board.  OpenGL's GLX extension integrates OpenGL with the X 
  92.       Window System.  This article describes OpenGL's functionality and how 
  93.       it is used with X.  A simple OpenGL program using Xlib is presented.  
  94.       OpenGL is compared and contrasted with PEX, a 3D graphics interface 
  95.       designed specifically for X.  The two subsequent articles in this 
  96.       series describe how to integrate OpenGL with Xlib and Motif programs.
  97.  
  98.  -----------------------------------------------------------------------------
  99.  
  100.     xlib.ps:     "OpenGL(tm) and X, Part 2:  Using OpenGL with Xlib", Mark
  101.          Kilgard, "The X Journal", January/February, 1994.
  102.  
  103.       This is the second article in a three-part series about using the 
  104.       OpenGL(tm) graphics system and the X Window System.  A moderately
  105.       complex OpenGL program for X is presented.  Depth Buffering, back-face
  106.       culling, lighting, display list modeling, polygon tessellation, double
  107.       buffering, and shading are all demonstrated.  The program adheres to
  108.       proper X conventions for colormap sharing, window manager communication, 
  109.       command line argument processing, and event processing.  After the 
  110.       example, advanced X and OpenGL issues are discussed including minimizing
  111.       colormap flashing, handling overlays, using fonts, and performing 
  112.       animation.  The last article in this series discussess integrating
  113.       OpenGL with the Motif toolkit.
  114.  
  115.  -----------------------------------------------------------------------------
  116.  
  117.     motif.ps:    "OpenGL(tm) and X, Part 3:  Integrating OpenGL with Motif",
  118.          Mark Kilgard, "The X Journal", May/June, 1994.
  119.  
  120.       This is the third article in a three-part series about using the 
  121.  
  122.  -----------------------------------------------------------------------------
  123.  
  124.     xtech.ps:  "X Server Multi-rendering for OpenGL and PEX", presented at the
  125.                8th Annual X Technical Conference, Boston, Mass., 1/25/94.
  126.  
  127.       ABSTRACT:  To support OpenGL (TM) and PEX rendering within the Silicon 
  128.       Graphics X server without compromising interactivity, we devised and 
  129.       implemented a scheme named "multi-rendering".  Making minimal changes to
  130.       the X Consortium sample server's overall structure, the scheme allows 
  131.       independent processes within the X server's address space to perform 
  132.       OpenGL rendering asynchronously to the X server's main thread of 
  133.       execution.  The IRIX operating system's process share group facility, 
  134.       user-level and pollable semaphores, and support for virtualized direct 
  135.       access rendering are all leveraged to support multi-rendering.  The 
  136.       Silicon Graphics implementation of PEX also uses the multi-rendering 
  137.       facility and works by converting rendering requests into OpenGL commands.
  138.       Mutli-rendering is contrasted with other schemes for improving server 
  139.       interactivity.  Unlike co-routines, multi-rendering supports multi-
  140.       processing;  unlike multi-threading, multi-rendering requires minimal 
  141.       locking overhead.
  142.  
  143.  -----------------------------------------------------------------------------
  144.  
  145.     gluSpec.ps:  The OpenGL(TM) Graphics System Utility Library
  146.     glxSpec.ps:  OpenGL(TM) Graphics with the X Window System(R)
  147.     OglSpec.ps:  The OpenGL(TM) Graphics System:  A Specification (Version 1.0)
  148.  
  149.  
  150. Copyright (c) 1992, 1993 Silicon Graphics, Inc. All Rights Reserved.
  151.  
  152.   gluSpec.ps:  The OpenGL(TM) Graphics System Utility Library
  153.  
  154.                The GL Utilities (GLU) library is a set of routines designed
  155.                to complement the OpenGL(TM) graphics system by providing
  156.                support for mipmapping, matrix manipulation, polygon
  157.                tessellation, quadrics, NURBS, and error handling.  Mipmapping
  158.                routines include image scaling and automatic mipmap generation.
  159.                A variety of matrix manipulation functions build projection
  160.                and viewing matrices, or project vertices from one coordinate
  161.                system to another.  Polygon tessellation routines convert
  162.                concave polygons into triangles for easy rendering.  Quadrics
  163.                support renders a few basic quadrics such as spheres and cones.
  164.                NURBS code maps complicated NURBS curves and trimmed surfaces
  165.                into simpler OpenGL evaluators.  Lastly, an error lookup
  166.                routine translates OpenGL and GLU error codes into strings.
  167.  
  168.  
  169.   glxSpec.ps:  OpenGL(TM) Graphics with the X Window System(R) (Version 1.0)
  170.  
  171.                This document describes GLX, the OpenGL extension to the X
  172.                Window System.  It refers to concepts discussed in the OpenGL
  173.                specification, and may be viewed as an X specific appendix to
  174.                that document.  Parts  of the document assume some
  175.                acquaintance with both the OpenGL and X.
  176.                In the X Window System, OpenGL rendering is made available as
  177.                an extension to X in the formal X sense:  connection and
  178.                authentication are accomplished with the normal X mechanisms.
  179.                As with other X extensions, there is a defined network
  180.                protocol for the OpenGL rendering commands encapsulated
  181.                within the X byte stream.
  182.                Since  performance is critical in 3D rendering, there is a
  183.                way for OpenGL rendering to bypass the data encoding step,
  184.                the data copying, and interpretation of that data by the X
  185.                server.  This direct rendering is possible only when a
  186.                process has direct access to the graphics pipeline.
  187.                Allowing for parallel rendering has affected the design of
  188.                the GLX interface.  This has resulted in an added burden on
  189.                the client to explicitly prevent parallel execution when
  190.                that is inappropriate.
  191.                X and the OpenGL have different conventions for naming entry
  192.                points and macros.  The GLX extension adopts those of the
  193.                OpenGL.
  194.  
  195.  
  196.   OglSpec.ps: The OpenGL(TM) Graphics System:  A Specification (Version 1.0)
  197.  
  198.               This document describes the OpenGL graphics system:  what it
  199.               is, how it acts, and what is required to implement it.  We
  200.               assume that the reader has at least a rudimentary
  201.               understanding of computer graphics.  This means familiarity
  202.               with the essentials of computer graphics, algorithms, as well
  203.               as familiarity with basic graphics hardware and associated
  204.               terms.
  205.  
  206.  
  207.     
  208.     These 3 documents first appeared on the OpenGL CD given out at 
  209.     out at siggraph 1993.  From the top-level README of that CD:
  210.  
  211.  
  212. The spec directory contains no source code, but it does contain
  213. Release 1.0.10 of the OpenGL Specification, including the OpenGL
  214. Utility Library, and the API for the OpenGL extension to the X Window
  215. System, as released by the OpenGL Architectural Review Board.  As of
  216. July, 1993, the OpenGL Architectural Review Board consists of Digital
  217. Equipment, IBM, Intel, Microsoft, and Silicon Graphics.
  218.  
  219. The OpenGL Specification will enable people to get a more in-depth
  220. understanding of the internals of OpenGL.  (For most people, the
  221. Addison-Wesley book series will be enough documentation.)  However,
  222. this copy of the Specification is not a license to implement OpenGL
  223. or to use the trademark OpenGL(TM).  Contact Mason Woo at Silicon 
  224. Graphics, Inc. for more details about licensing.
  225.  
  226. ------------
  227. Copyright (c) 1992, 1993 Silicon Graphics, Inc. All Rights Reserved.
  228.  
  229. The OpenGL(TM) Specification on this CD-ROM is protected by
  230. International Copyright Law, and is proprietary to Silicon
  231. Graphics, Inc.  You may not copy, adapt, distribute, or publicly
  232. perform or display any portion of such material without the
  233. express, prior written consent of Silicon Graphics, Inc.  Your
  234. receipt or possession of the OpenGL Specification does not grant
  235. to you or anyone else any right to reproduce, create derivative
  236. works based on or distribute or otherwise disclose any of its
  237. contents, or to manufacture, use or sell anything that embodies
  238. any of the material included herein, in whole or in part,
  239. provided, however, that you may print one interpreted copy of the
  240. PostScript(R) version of the OpenGL Specification provided on
  241. this CD-ROM for your personal reference in connection with your
  242. use of an OpenGL product.
  243.  
  244. THE MATERIAL EMBODIED ON THIS CD-ROM IS PROVIDED TO YOU "AS-IS"
  245. AND WITHOUT WARRANTY OF ANY KIND, EXPRESS, IMPLIED OR OTHERWISE,
  246. INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF MERCHANTABILITY OR
  247. FITNESS FOR A PARTICULAR PURPOSE.  IN NO EVENT SHALL SILICON
  248. GRAPHICS, INC.  BE LIABLE TO YOU OR ANYONE ELSE FOR ANY DIRECT,
  249. SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY
  250. KIND, OR ANY DAMAGES WHATSOEVER, INCLUDING WITHOUT LIMITATION,
  251. LOSS OF PROFIT, LOSS OF USE, SAVINGS OR REVENUE, OR THE CLAIMS OF
  252. THIRD PARTIES, WHETHER OR NOT SILICON GRAPHICS, INC.  HAS BEEN
  253. ADVISED OF THE POSSIBILITY OF SUCH LOSS, HOWEVER CAUSED AND ON
  254. ANY THEORY OF LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE
  255. POSSESSION, USE OR PERFORMANCE OF THIS CD-ROM, OR THE MATERIAL
  256. CONTAINED ON THIS CD-ROM.
  257.  
  258. U. S. Government Restricted Rights Legend
  259.  
  260. Use, duplication, or disclosure by the Government is subject to
  261. restrictions set forth in FAR 52.227.19(c)(2) or subparagraph
  262. (c)(1)(ii) of the Rights in Technical Data and Computer Software
  263. clause at DFARS 252.227-7013 and/or in similar or successor
  264. clauses in the FAR or the DOD or NASA FAR Supplement.
  265. Unpublished-- rights reserved under the copyright laws of the
  266. United States.  Contractor/manufacturer is Silicon Graphics,
  267. Inc., 2011 N.  Shoreline Blvd., Mountain View, CA 94039-7311.
  268.  
  269. OpenGL is a trademark of Silicon Graphics, Inc.  PostScript is a
  270. registered trademark of Adobe Systems Incorporated.
  271.  
  272.